Skip to content

[PRD] zendesk: new-platform proposal - #230

Open
asachs01 wants to merge 1 commit into
mainfrom
prd/zendesk-plugin-10
Open

[PRD] zendesk: new-platform proposal#230
asachs01 wants to merge 1 commit into
mainfrom
prd/zendesk-plugin-10

Conversation

@asachs01

@asachs01 asachs01 commented Aug 30, 2026

Copy link
Copy Markdown
Collaborator

Why a PRD instead of a plugin

Issue #10 requests a Zendesk plugin. Per CONTRIBUTING.md's Tier 3 process ("Building a plugin for a vendor we don't support yet? Submit a PRD first"), Zendesk needs a PRD before implementation — it has zero existing infrastructure in this repo (no gateway vendor entry, no local MCP server, no plugin scaffold).

What I found

Zendesk ships its own official hosted MCP server (https://<subdomain>.zendesk.com/api/mcp, OAuth-gated, in early access since summer 2026) — so this doesn't need a WYRE-built zendesk-mcp server, same pattern as Stripe/Slack/HubSpot/PandaDoc already in this repo.

What this PRD deliberately does NOT do

Name specific MCP tool names. Zendesk's official server has no live tools/list I could verify against, and several community Zendesk MCP servers exist on GitHub with different tool surfaces than the official one — guessing from those (or from REST endpoint names) would recreate exactly the tool-name-drift problem issue #178's corrective pass just spent a full pass fixing across 18 other plugins. Flagged as an explicit prerequisite in Success Criteria and Open Questions instead.

Scoped to read/triage/lookup (tickets, orgs, users, help center, reference data) — write actions are explicitly out of scope for v1.

Refs #10


View with [code]smith Autofix with [code]smith
Need help on this PR? Tag @codesmith-bot with what you need. Autofix is disabled.

Per CONTRIBUTING.md's Tier 3 process, this is a proposal for the
Zendesk plugin requested in #10 — not an implementation. Zendesk has
zero existing infrastructure in this repo (no gateway vendor entry, no
local MCP server, no plugin scaffold), which puts it squarely in the
"new platform" tier requiring PRD + maintainer approval before build.

Zendesk does ship its own official hosted MCP server (early access
since summer 2026, OAuth-gated, per-tenant subdomain) rather than
requiring a WYRE-built server — this PRD scopes the plugin to connect
to that directly, mirroring how Stripe/Slack/HubSpot/PandaDoc already
work in this repo.

Deliberately does not name specific MCP tools: Zendesk's server was in
early access with no live tools/list available to verify against, and
guessing names from REST endpoints or third-party community servers is
exactly the failure mode issue #178's corrective pass just spent a full
pass fixing across 18 other plugins. Flagged as an explicit prerequisite
in Success Criteria and Open Questions instead.

Refs #10
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant